Inside Macintosh: QuickDraw GX Objects /

Chapter 8 - Tag Objects / Tag Objects Reference

Functions / Creating and Manipulating Tag Objects

GXCloneTag

You can use the GXCloneTag function to clone a tag object--that is, to add a reference to it and increment its owner count.

gxTag GXCloneTag(gxTag source);

source

A reference to the tag object to clone.

function result

A reference to the cloned tag object.

DESCRIPTION

The GXCloneTag function increments the owner count of the tag object referenced in
the source parameter. You typically use this function when you want to create another reference to an existing tag object instead of creating a distinct copy of the tag.

This function returns as its function result a reference to the tag object--the same reference you pass in as the source parameter. It also increments the tag object's owner count.

ERRORS, WARNINGS, AND NOTICES

Errors
tag_is_nil
tag_access_restricted	(debugging version)

SEE ALSO

Owner counts for tag objects are discussed in the section "Copying, Comparing, and Cloning Tag Objects" beginning on page 8-9, and in the section "Manipulating a Tag Object's Owner Count" beginning on page 8-11.

To examine the owner count of a tag object, use the GXGetTagOwners function, described on page 8-20. To decrement the owner count of a tag, use the GXDisposeTag function, described on page 8-14.